メインコンテンツまでスキップ
バージョン: DAI 7.3

Eggplant DAIでのSUT管理

Controller > SUTsから、Eggplant DAIでシステムアンダーテスト(SUT)の接続を管理し、リモートシステムでのテスト自動化を実現することができます。また、SUTと接続タイプの表示、追加、編集、削除もここで行うことができます。接続が追加、削除、または変更されると、SUTのリストは動的に更新されます。任意の時点で任意の数のSUTを接続することができます。

ノート

他のユーザーまたは進行中のテストランによって使用中のSUTはロックされていると表示されます。ロックされたSUTは、ロックが解除されるまで他の目的で使用することはできません。

以下の列が表示され、各SUT接続の詳細を一目で確認することができます:

  • Name: SUTの表示名。
  • Description: SUTの説明。
  • Criteria Tags: 選択されたSUTに定義された基準タグ。SUTには複数の基準タグを持つことができます。
  • Connection Types: SUTに定義された接続タイプ。次の接続タイプのうち1つ以上を持つことができます:VNC、RDP、WebDriver、Citrix、Sauce Labs Browser、Sauce Labs Device、Android Device、iOS Device。
  • Status: SUTの可用性を示します。オプションは次の通り:LockedUnlocked(利用可能)、Disabled

ActionsメニューActions menu iconをクリックして、SUTとその関連接続タイプをEditDelete、またはUnlockします。

SUT名をクリックして、SUTの詳細を全て表示します。

Filter All をクリックして、AllAvailableLockedDisabled によってSUTの表示をフィルタリングします。

ノート

Eggplant DAIでSUTsを編集、削除、またはロック解除するためには、管理者権限が必要です。

SUT接続の追加

ノート

DAI Eggplant Cloud(以前はHosted DAIと呼ばれていました)を使用している場合、テスト実行中にCloud SUTsが自動的に割り当てられるので、手動でSUTを登録または追加する必要はありません。

Eggplant DAIでは、SUTに接続する方法を様々に定義することができます。Eggplant DAIは、デスクトップシステムとモバイルデバイス接続のテストにVirtual Network Computing(VNC)とRemote Desktop Protocol(RDP)接続を、Webブラウザ上のアプリ、Webアプリケーション、モバイルデバイスのオブジェクトベースのテストにWebDriverをサポートしています。また、Citrix StorefrontやSauce Labs BrowsersとSauce Labs Devicesへの接続もサポートしています。SUTに対して定義された接続は、SUTが**Controller > Runner**でテストを実行する際に自動的に確立されます。

新しいSUT接続を追加するには、以下の手順を実行します:

  1. Controller > SUTs に移動します。

  2. 上部のメニューから、[+新しい SUT] をクリックします。

  3. SUTの表示 NameDescription を入力して、既存のSUTリストで簡単に識別できるようにします。

  4. タグ名を入力し、Enter を押すことで Criteria tags を追加します。テストで使用するSUTを選択するために、任意の数の基準タグを追加できます。

  5. リストからクリックして選択することで、このSUTに使用される Execution Environment(s) を追加します。実行環境の特定の文字を入力することでリストをフィルタリングできます。任意の数の実行環境を追加できます。このフィールドを空白のままにすると、テストが実行される際に利用可能な実行環境が使用されます。Connection TypeAndroid Device または iOS Device の場合、このフィールドは必須になります。

    Execution Environment list

  6. 必要に応じて、Disable SUTのチェックボックスを選択します(オプション)。これにより、テストを実行する際にSUTが使用されるのを防ぎます。

  7. Add Connection + をクリックして、SUTのための Connection Type を定義します。

  8. 次のオプションから Connection Type を選択します。

    • RDP: RDP経由での接続を選択します。
    • VNC: VNC経由での接続を選択します。
    • WebDriver: Selenium WebDriverを使用した接続を選択します。
    • Citrix: Citrixを使用した接続を選択します。
    • Sauce Labs Browser: Sauce Labs Browserを使用した接続を選択します
    • Sauce Labs Device: Sauce Labs Deviceを使用した接続を選択します。
    • Android Device: Android Deviceを使用した接続を選択します。
    • iOS Device: iOS Deviceを使用した接続を選択します。
  9. (任意) RDPVNC、またはWebDriverを選択した場合、セカンダリ接続を追加するオプションが表示されます。

    下記の参照セクションでは、各接続タイプを詳しく追加する方法を説明します。

    ノート

    SUTを作成するためには、プライマリ接続が必要です。 セカンダリ接続は任意です。 これらのルールに基づいて接続を定義できます。

    • RDP がプライマリ接続の場合、セカンダリ接続は WebDriver のみになります。
    • VNC がプライマリ接続の場合、セカンダリ接続は WebDriver のみになります。
    • WebDriver がプライマリ接続の場合、セカンダリ接続は RDP または VNC のみになります。RDP または VNC が接続リストに追加されると、それがプライマリ接続になり、WebDriver がセカンダリ接続になります。
    • CitrixSauce Labs BrowserSauce Labs DeviceAndroid Device、または iOS Device がプライマリ接続である場合、使用可能なセカンダリ接続はありません。
  10. Save and closeをクリックします。

新しく追加されたSUT接続は、SUTs タブに表示されます。

Step by Step: RDP接続詳細の入力

  1. Connection Type リストから RDP を選択します。
  2. 接続したいSUTの IP address または Hostname を入力します。RDP接続はデフォルトでポート3389を使用しますが、必要に応じて変更できます。
  3. RDP接続の場合、Password および Username フィールドは、接続するWindowsユーザーアカウントを指します。この情報はRDP接続に常に必要です。
  4. RDPセッションウィンドウが開く Width および Height を指定します。
  5. Connection Types リストに接続詳細を保存するために Save connection をクリックします。
ノート

RDP接続を利用するためには、SUTが接続を受け入れるように設定されている必要があります。

RDP設定

  • Server (IP Address, Hostname):* SUTのIPアドレスまたはホスト名を入力します。
  • Port: SUTに接続するためのポート番号。
  • Username: SUTに接続するRDP接続のユーザー名。
  • Password: SUTに接続するRDP接続のパスワード。
  • Color Depth: (Optional)* VNCセッションが開く色の深さ。接続の速度を上げるために、ドロップダウンリストから利用可能な低い深さを選択して、色の深さを減らすことができます。
    • Default: SUTのネイティブ表示と同じ色の深さでSUTを描画するために選択します。
    • Millions (32-bit): SUTの色の深さを人間の目には見えない数百万色に増やすために選択します。
    • Thousands (16-bit): SUTの色の深さを65,536色に減らすために選択します。
    • 256(8ビット): これを選択して、SUTの色深度を256色に減らします。256 (8-bit): SUTの色の深さを256色に減らすために選択します。
  • Width and Height: (Optional) RDPセッションウィンドウが開く幅と高さ。

Step by Step: VNC接続詳細の入力

  1. Connection Type リストから VNC を選択します。
  2. 接続したいSUTの IP address または Hostname を入力します。VNC接続はデフォルトでポート5900を使用しますが、必要に応じて変更できます。
  3. VNC接続の場合、Username および Password フィールドは、SUT上のVNCサーバーを指します。この情報がVNCサーバーに接続するために必要な場合は、ここに入力します。Windowsでは、Password フィールドにSSHキーを入力します。
  4. (任意)この接続に必要なSSH Settingsを追加します。
  5. Connection Types リストに接続詳細を保存するために Save connection をクリックします。

VNC設定

  • Server (IP Address, Hostname): SUTのIPアドレスまたはホスト名を入力します。

  • Port: SUTに接続するためのポート番号。

  • Username: (Optional) SUTに接続するVNC接続のユーザー名。

  • Password: (Optional) SUTに接続するVNC接続のパスワード。

  • Color Depth: (Optional) VNCセッションが開く色の深さ。接続の速度を上げるために、ドロップダウンリストから利用可能な低い深さを選択して、色の深さを減らすことができます。

    • Default: SUTのネイティブ表示と同じ色の深さでSUTを描画するために選択します。
    • Millions (32-bit): SUTの色の深さを人間の目には見えない数百万色に増やすために選択します。
    • Thousands (16-bit): SUTの色の深さを65,536色に減らすために選択します。
    • 256 (8-bit): SUTの色の深さを256色に減らすために選択します。
  • Scale Ratio: モバイルデバイスの大画面や高解像度を使用している場合にパフォーマンスを向上させるために、VNCサーバーを各次元で50パーセント縮小するオプションを選択します。

  • SSH Settings: (Optional) Secure Shell(SSH)は、データ暗号化を使用して情報を安全に転送するネットワークプロトコルです。

    • Host: SUTの安全な接続のためのSSHトンネルをホストするコンピューターのホスト名またはIPアドレス。
    • Username: SUTユーザーがSSHホストにログインする際のアカウント名。
    • Password: SUTユーザーがSSHホストにログインする際のパスワード
    ノート

    RDP または VNC をプライマリ接続として、WebDriver をセカンダリ接続として追加すると、WebDriver のサーバーフィールドはデフォルトで無効になっていることがわかります。これを変更するには、RDP または VNC フィールドからサーバーフィールドを変更する必要があります。

Step by Step: WebDriver接続詳細の入力

  1. Connection Type リストから WebDriver を選択します。

  2. 接続したいSUTの IP address または Hostname を入力します。WebDriver接続はデフォルトでポート4444を使用しますが、必要に応じて変更できます。

  3. 次のオプションから Browser を選択します:

    • Chrome
    • Firefox
    • Safari
    • Microsoft Edge
    • Internet Explorer
    • None
  4. JSON形式を使用して、必要なWebDriver Capabilities をキーバリューペアとして追加します。

    ノート

    テストで上記の Browser ドロップダウンリストにリストされていないブラウザーを使用する場合は、None を選択し、Capabilities フィールドのキーバリューペアの1つとして browserName: <your browser> を入力します。

  5. Connection Types リストに接続詳細を保存するために Save connection をクリックします。

    ノート

    このSUTを使用するように設定された任意のWebDriverデバイスは、テストを実行するときに自動的に接続します。あなたはWebDriver()関数をSenseTalkスニペットに使用して、この接続にアクセスし、それに対してActionを実行することができます。

WebDriver設定

  • Server (IP Address, Hostname): SUTのIPアドレスまたはホスト名を入力します。
  • Port: SUTに接続するためのポート番号。
  • Browser: (Optional) テスト中にSUTによって起動されるブラウザーのタイプ。
  • Capabilities: (Optional) セッションでサポートされている機能を伝達するために使用される有効なJSON。

Step by Step: Citrix接続詳細の入力

  1. Connection Type リストから Citrix を選択します。
  2. Citrixアカウントの UsernamePassword を入力します。
  3. Storefront URL を入力します。例:http://{server}/Citrix/{company name}
  4. Application 名を入力します。
  5. (任意) Screenshot Interval を入力します。デフォルト値は 400 ミリ秒です。
  6. (任意) 解像度の Width and Height を入力します。デフォルト値は 1600x900 です。
  7. Connection Types リストに接続詳細を保存するために Save Connection をクリックします。

セットアップの詳細については、Install Eggplant Functional and Citrix を参照してください。

ノート

Citrix接続のサポートは、Eggplant FunctionalのWindows版でのみ利用可能です。

Citrix設定

  • Username: SUTに接続するCitrixのユーザー名。
  • Password: SUTに接続するCitrixのパスワード。
  • Storefront URL: Citrix StorefrontのURL。
  • Application: Citrixで起動するアプリケーションまたはデスクトップの名前。
  • Screenshot Interval: (Optional) 2つの連続したCitrixフレームバッファのキャプチャ間の待機時間。
  • Width and Height: (Optional) Citrixウィンドウが開く幅と高さ。

Step by Step: Sauce Labs Browser接続詳細の入力

  1. Connection Type リストから Sauce Labs Browser を選択します。
  2. 使用する Sauce Labs アカウントの usernameAPI キー を入力します。
  3. 利用可能なオプションから Data Center を選択します。
  4. Sauce Labsの資格情報と接続を検証するには、Check Connectionをクリックします。アカウントが正常に検証されると、より多くのSauce Labs設定が構成可能になります。
  5. Sauce LabsのSUTでテストするオペレーティングシステムのタイプを指定するには、利用可能なオプションからPlatform Nameを選択します。
  6. SUTで起動してテストするブラウザのタイプを指定するには、利用可能なオプションからBrowser Nameを選択します。
  7. (任意)SUTでテストする選択したブラウザのバージョンを指定するには、利用可能なオプションからVersionを選択します。バージョンが指定されていない場合、デフォルトでSauce Labsから利用可能な最新バージョンが使用されます。
  8. (オプション)テスト用に開きたいSUTウィンドウのサイズ(解像度)を指定するには、WidthHeightを指定します。デフォルト値は 1024x768 です。
  9. (任意) ブラウザーが起動する際にナビゲートしたい URL を入力します。
  10. (トンネルプロキシユーザー向け必須)Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
  11. (トンネルプロキシユーザー向け必須)Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Name名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Ownerを提供するまで、このフィールドは表示されません。
  12. Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
ノート

あなたのSauce Labs接続は3時間後に終了します。

サポートされているPlatform NameBrowser Name、およびVersionの詳細については、サポートされているブラウザ&デバイスを参照してください。また、Tunnel OwnerおよびSauce Labsトンネルプロキシを使用したトンネルの詳細については、Sauce LabsのドキュメントのSauce Connect Proxiesを参照してください。

Sauce Labs Browser設定

  • username: Sauce Labs アカウントのユーザー名。
  • API Key: Sauce Labs アカウントの API キー。詳細については、[Sauce Labs User Settings.
  • Data Center: テストが実行され、関連するアーティファクトが保存される Sauce Labs サーバーの場所。
  • Check Connection: Sauce Labsアカウントを検証し、より多くのSauce Labs設定を有効にします。
  • Platform Name: Sauce Labs SUT に使用するオペレーティング システム。
  • Browser Name: Sauce Labs Sut に使用するシステム。
  • Version: (Optional) テストで使用するブラウザーのバージョン。
  • Width and Height: (Optional) Sauce Labsブラウザ用に開くウィンドウの解像度。サポートされている解像度の詳細については、Sauce Labsプラットフォーム構成を参照してください。
  • URL: (Optional) ブラウザーが起動する際にナビゲートするウェブサイトアドレス。
  • Tunnel Owner: (Required for tunnel proxy users) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。 トンネル所有者を指定するまで、トンネル名フィールドは表示されません。
  • Tunnel Name: (Required for tunnel proxy users) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル名。 トンネル所有者を指定するまで、このフィールドは表示されません。

Step by Step: Sauce Labs Device接続詳細の入力

  1. Connection Type リストから Sauce Labs Device を選択します。
  2. 使用する Sauce Labs アカウントの usernameAPI キー を入力します。
  3. 利用可能なオプションから Data Center を選択します。
  4. Check Connection をクリックして、Sauce Labs アカウントと接続を検証します。Sauce Labs アカウントが正常に検証されると、構成のためにさらに多くの Sauce Labs 設定が表示されます。
  5. 利用可能なオプションから Platform Name を選択し、Sauce Labs SUT でテストするオペレーティング システムの種類を指定します。
  6. 使用可能なオプションから Device Name を選択し、テストするモバイル デバイスのタイプを指定します。
  7. (オプション) Sauce Labs デバイスで起動する App へのパスを入力します。指定しない場合、アプリは起動せずにデバイスが起動します。詳細については、Mobile App Storage.を参照してください。
  8. Tunnel Owner: (Tunnel proxy usersの場合は必須) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。 Tunnel Ownerを指定するまで、Tunnel Nameフィールドは表示されません。
  9. (tunnel proxy users向け必須)Sauce Labs接続でトンネルプロキシを使用している場合は、Tunnel Owner名を入力してください。なお、Sauce Labsのトンネルプロキシが実行されている必要があります。Tunnel Nameフィールドは、Tunnel Ownerを提供するまで表示されません。
  10. Connection Types リストに接続詳細を保存するために Save Connection をクリックします。
ノート

あなたのSauce Labsの接続は3時間後に終了します。

Sauce Labs Device設定

  • username: Sauce Labs アカウントのユーザー名。
  • API Key: Sauce Labs アカウントの API キー。詳細については、Sauce Labs ユーザー設定 を参照してください。
  • Data Center: テストが実行され、関連するアーティファクトが保存される Sauce Lab サーバーの場所。
  • Check Connection: Sauce Labs アカウントを検証し、より多くの Sauce Labs 構成フィールドを有効にします。
  • Platform name: Sauce Labs デバイスのオペレーティング システム。
  • Device name: モバイルデバイスのタイプとバージョン。
  • App: (Optional) テストしたいモバイルアプリが含まれる.ipa、.apk、.aab、または.zipファイルへのパスを設定することができます。
  • Tunnel Owner: (tunnel proxy usersの場合は必須) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル所有者名。 Tunnel Ownerを指定するまで、Tunnel Nameフィールドは表示されません。 DAI 接続でトンネル プロキシを使用するには、トンネル プロキシが実行されている必要があります。
  • Tunnel Name: (tunnel proxy usersの場合は必須) Sauce Labs 接続でトンネル プロキシを使用する場合のトンネル名。 トンネル所有者を指定するまで、このフィールドは表示されません。

サポートされている Platform name および Device name の詳細については、サポートされているブラウザーとデバイス を参照してください。 Tunnel OwnerTunnel Owner、および Sauce Labs Tunnel ProxyでのTunnelの使用の詳細については、「Sauce Connect Proxy」を参照してください。 connect/) (Sauce Labs ドキュメント)。

Step by Step: Android Device接続詳細の入力

  1. Connection Type リストから Android Device を選択します。
  2. Android Gateway UIにリストされているAndroidデバイスの Device ID を入力します。
  3. Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。

Androidデバイスへの接続についての詳細は、Connecting to Devices を参照してください。

Android Device設定

  • Device ID: シリアル番号、エミュレーター名。

Step by Step: iOS Device接続詳細の入力

  1. Connection Type リストから iOS Device を選択します。
  2. iOS Gateway UI にリストされている iOS デバイスの UDID を入力します。
  3. (任意) Developer certificate name or thumbprint を入力します。
  4. Provisioning profile name or identifier を入力します。
  5. Save Connection をクリックして、接続の詳細を Connection Types リストに保存します。
ノート

以前に選択したiOSデバイスに接続が設定されており、既存の開発者証明書がまだ有効である場合、Developer certificate name or thumbprint および Provisioning profile name or identifier に入力した値は無視されます。

iOSnbsp;ゲートウェイを使用した iOS デバイスへの接続の詳細については、 iOS Devices を参照してください。

iOS Device接続設定

  • UDID: iOSデバイスのユニークな識別子。
  • Developer certificate name or thumbprint: (Optional) 開発者証明書へのパス。
  • Provisioning profile name or identifier: プロビジョニングプロファイルへのパス。

SUT接続の編集

既存のSUT接続を編集するには:

  1. Controller > SUTs に移動します。
  2. 更新に興味のあるSUT接続を見つけ、Actions menu icon Actions メニューから Edit を選択します。
  3. ここで、SUT情報または接続の詳細を更新できます。

SUT接続の表示

既存のSUTの詳細を表示するには:

  1. Controller > SUTs に移動します。
  2. 表示したいSUT接続を見つけ、接続名をクリックします。
ノート

SUTがロックされている場合は、Status 列の鍵アイコンをクリックして解除します。

パスワードとAPIキーについて

パスワードとAPIキーは書き込み専用です。接続詳細を保存した後でパスワードやAPIキーに再度アクセスすることはできませんので、将来アクセスする必要がある場合はパスワードやAPIキーを別の安全な場所に保存しておく必要があります。

パスワードまたはAPIキーを追加または編集する際には、Toggle icon トグルアイコンをクリックして、保存前に新しく入力されたパスワードまたはAPIキーの値を表示できます。